home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 21 / Cream of the Crop 21 (Terry Blount) (October 1996).iso / windows / themeins.zip / Theme Installer.txt < prev   
Text File  |  1996-09-06  |  7KB  |  156 lines
  1. Theme Installer v1.03
  2. (c) 1996 Jonathan Potter
  3.  
  4. ** Please see the bottom of this file for history information **
  5.  
  6. 1. Introduction
  7.  
  8. This is a fairly straight-forward program written more as an exercise than
  9. anything else. I've come back to Windows programming after a long absence
  10. and this is my first Win95 program. Therefore, it's fairly basic, but it
  11. seems to work ok.
  12.  
  13. Theme Installer automates (to some extent) the process of installing
  14. Plus! Themes. There are hundreds of different themes available now, and all
  15. the ones I have seen need to be installed manually (copy these files to your
  16. Plus!\Themes directory, these to Windows\System, etc..) What's more, they had
  17. to be uninstalled manually too.
  18.  
  19. Theme Installer reads the .theme file for the theme and works out where
  20. everything needs to go, and copies it there automatically.
  21.  
  22. It also adds an Uninstall entry to the Registry. This allows you to
  23. uninstall the theme from the Add & Remove Software control panel.
  24.  
  25.  
  26. 2. Installation
  27.  
  28. To install Theme Installer, simply copy the executable somewhere nice and
  29. safe (c:\Program Files is a good choice.) Once you have it in its permanent
  30. location, run it (from Explorer or Start/Run, etc).
  31.  
  32. A message box will appear asking you if you want to install the
  33. Theme Installer Shell Extension. This simple extension adds an "Install"
  34. item to the context menu for Plus! Theme files
  35. (HKEY_CLASSES_ROOT\ThemeFile\Shell).
  36.  
  37.  
  38. 3. Usage
  39.  
  40. Once the Shell Extension has been installed, all you need to do to install
  41. a new theme is select the .theme file with mouse button 2 and choose the
  42. Install command from the context menu. Theme Installer automatically
  43. determines the location of your Windows and Themes directories and copies the
  44. theme files to their correct locations.
  45.  
  46. Removing installed Themes is straight-forward. Open the Add & Remove Software
  47. applet in the Control Panel, find your theme in the list and click the
  48. Remove button. Once again, Theme Installer reads the .theme file to find out
  49. what to delete, so this file must still be present in the Themes directory.
  50. For safety's sake, no .DLL or .EXE files will be deleted (in case they are
  51. shared files); if a theme uses these for the screen saver, you will have to
  52. delete them manually (this is pretty rare in my experience).
  53.  
  54. The Theme Installer keeps a log of the files it copies and the directories
  55. it creates, so it knows exactly what to remove. This allows a theme to use
  56. components not supplied with it itself (for example, some themes use the
  57. standard Windows or Plus! cursors).
  58.  
  59.  
  60. 4. Installing Startup, Shutdown screens and Fonts
  61.  
  62. Theme Installer can install startup screens, shutdown screens and fonts.
  63. To do this, the theme file creator must (manually) insert a special section
  64. in the theme file. This is because the Plus! themes system does not support
  65. these files itself. This special section looks like this:
  66.  
  67.     [ThemeInstallerSpecial]
  68.     StartupScreen=<startup pic name>
  69.     ShutdownWaitScreen=<shutdown wait pic name>
  70.     ShutdownSafeScreen=<shutdown safe pic name>
  71.     Font=%FontDir%<font name>
  72.     Font=%FontDir%<font name>
  73.     etc.
  74.  
  75. StartupScreen, ShutdownWaitScreen and ShutdownSafeScreen are the startup and
  76. shutdown screens. You can use any filename for these screens; they will
  77. automatically be renamed to Logo.sys, LogoW.sys and LogoS.sys when they are
  78. copied. The existing startup and shutdown screens will be renamed to Logo.old,
  79. LogoW.old and LogoS.old, and will be recovered when the user uninstalls the
  80. theme.
  81.  
  82. %FontDir% is a magic tag for Theme Installer that causes it to insert the
  83. path of the Windows\Fonts directory (similar to %ThemeDir% and %WinDir%).
  84. You can install as many fonts as you like (each on a separate line in the
  85. theme file).
  86.  
  87.  
  88. 5. Uninstalling
  89.  
  90. You should not move Theme Installer once you have installed it, as the
  91. Uninstall entries it creates for themes point to this location. If you do
  92. want to remove Theme Installer, run the program again and it will allow you
  93. to remove the shell extension. You can then delete the executable.
  94.  
  95.  
  96. 6. Distribution
  97.  
  98. Theme creators are free to distribute Theme Installer with their themes.
  99. If the program is run without a supplied filename, it will search its current
  100. directory for a .theme file to install. This means you can ship an archive
  101. with Theme Installer in the same directory as the theme files, and all the
  102. user has to do is double-click on the Installer icon. Note that if they want
  103. to be able to uninstall the theme the Theme Installer program has to be in
  104. the same location as when the theme was installed, so you might want to point
  105. this out in any documentation you supply.
  106.  
  107.  
  108. 7. Tips on Theme Installation
  109.  
  110. Theme Installer will install most themes with no intervention from you.
  111. The .theme file (if you are viewing by icons, it has the same icon as the
  112. Desktop Themes control panel applet) MUST be in the same folder as all the
  113. theme components. Many themes are distributed this way, but some have the
  114. .theme file in one folder, and the components in sub-directory of that.
  115. If this is the case, you have to move the .theme file into the same folder
  116. as the components before installing.
  117.  
  118. I've noticed that many themes are shipped with an incorrect screen saver
  119. defined. If you get an error saying a component could not be copied,
  120. you can select Ok to continue the installation, skipping over the
  121. troublesome file. Selecting cancel will remove anything installed up to this
  122. point.
  123.  
  124.  
  125. 8. Copyright
  126.  
  127. This program is freeware, but not public domain, and is (c) 1996 by
  128. Jonathan Potter. You may do with it what you wish. Any comments,
  129. bug reports, etc, are welcome. Please email me at jpotter@lss.com.au.
  130.  
  131. - Jon
  132.  
  133.  
  134.  
  135. -----------------------------
  136. Program history :
  137.  
  138.    v1.0              - initial release
  139.  
  140.    v1.01  (2 Aug 96) - Theme Installer now stores information about what
  141.                        it actually installs in the .theme file that is
  142.                        copied (the original is not touched).
  143.  
  144.                        This allows it to remove only the files and
  145.                        directories that it created. Some themes use standard
  146.                        Windows or Plus! objects (eg for cursors), and v1.0
  147.                        Theme Installer would have deleted these along with
  148.                        the theme files if you uninstalled a theme.
  149.  
  150.    v1.02 (20 Aug 96) - Changed the context menu command from "Install" to
  151.                        "&Install Theme"
  152.  
  153.    v1.03  (5 Sep 96) - Added [ThemeInstallerSpecial] key facility, to enable
  154.                        the installation of startup screens, shutdown screens
  155.                        and fonts.
  156.